home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asm_n_z.zip / TOUCHE.DOC < prev    next >
Text File  |  1986-06-01  |  4KB  |  89 lines
  1. TOUCHE.DOC                        Version 1.00
  2. ----------                        ------------
  3.  
  4. Copyright (c) 1986  Raymond Moon  ALL RIGHTS RESERVED
  5.  
  6.  
  7. INTRODUCTION
  8.  
  9. TOUCHE is a file date maintenance utility, normally called TOUCH,
  10. designed to complement an UNIX style file maintenance utility called
  11. MAKE.  Since the MAKE program will make decisions based on the files'
  12. date/time stamps, there is a need for an easy way to change the date on
  13. a file.  That is the purpose of TOUCHE.  It will change the file
  14. date/time in the directory for all files listed on TOUCHE's command
  15. line. 
  16.  
  17. BACKGROUND
  18.  
  19. The usual method employed by TOUCH programs is to read a byte from a
  20. file and then write it back so that DOS will update the file's date/time
  21. stamp when the file is closed.  TOUCHE uses a different way to achieve
  22. the same results.  DOS function call 57 hex is employed to change the
  23. date time stamp.  The reason for using this method is that all files will
  24. have exactly the same date/time stamp.  This is important because TOUCHE
  25. will accept wildcards in the filenames.  When using wildcards the
  26. possibility of touching both the object file and dependent file used in
  27. a MAKE description file becomes strong possibility.  In order to ensure
  28. that a dependent file will never have a date/time stamp before an object
  29. file, TOUCHE ensures that all files touched have the same exact date/time
  30. stamp.  Using DOS function call 57 hex has some unique side effects.
  31. TOUCHE can touch hidden and read_only files (this last one is definitely
  32. impossible to touch using the other method).
  33.  
  34. USE
  35.  
  36. TOUCHE is very easy to use.  Just type in the following at the DOS prompt:
  37.  
  38.     touche file1.ext file2.ext . . . fileN.ext
  39.  
  40. TOUCHE will accept drive, path, and wildcards in all file names.  TOUCHE
  41. will report one of three actions for every file on its command line:
  42.     -- Touched
  43.     -- Not Found
  44.     -- Cannot Touch
  45. "Touched" means that the indicated file's date/time stamp was
  46. successfully updated.  "Not Found" means that a matching file was not
  47. found.  "Cannot Touch" means that while the file could be opened, DOS
  48. Function call 57 Hex could not update the date/time stamp.  The author
  49. could not find any circumstances under which this error occurred.  Since
  50. the author does not have any experience with networking, code was added
  51. to check for this error so that TOUCHE would be well-behaved.
  52.  
  53. REQUIREMENTS
  54.  
  55. TOUCHE requires DOS 2.0+ and about 1K memory to run.
  56.  
  57. USER RESPONSIBILITIES
  58.  
  59. - All users are granted to make as many copies of this program as required.
  60. - There are no restrictions on how many different computers one user may
  61.   use TOUCHE.
  62. - Copies may be distributed to others as long as the fillowing
  63.   requirements are met:
  64.   -- All three files, TOUCHE.ASM, TOUCHE.COM, and TOUCHE.DOC, are
  65.      transfered as a whole.
  66.   -- These programs are distributed free of cost.  Only the cost fo the
  67.      media (e.g. diskette) can be charged.
  68.   -- The files are not modified in any way.
  69. - The source code is distributed with the program to encourage user
  70.   modification to meet individual needs, byt in no case will any of
  71.   these modifications be incorporated and distributed.
  72. - The author encourages comments.  Please leave comments, suggestions,
  73.   or suggested modifications in a message on Andy Smith's RBBS
  74.   (301-956-3396).
  75.  
  76. DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES
  77.  
  78. The author has taken due care in writing this program, and the program
  79. is supplied as is.  The author makes no expressed or implied warranty of
  80. any kind with regard to this program.  In no event shall the author be
  81. liable for incidental or consequential damages in connection with or
  82. arising out of the use of this program.
  83.  
  84. PROGRAM INFOMATION
  85.  
  86. TOUCHE was assembled using Microsoft MASM v3.0 with the /ml and /a
  87. switches set.
  88.  
  89. 31 May 1986                Raymond Moon